home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 019a / amac40.zip / COMT16.QM < prev    next >
Text File  |  1991-08-03  |  9KB  |  196 lines
  1. *                            COMT16.QM, v1.6b
  2. *                     Commenting/Uncommenting Macros
  3. *                        Written by Tom Hogshead
  4. *            With Macro Contributions by John Goodman, et al
  5. *                             August 2, 1991
  6. *  Key    Subfile              Description
  7. * =====  =========  =====================================================
  8. * ^(cursordown) {e:\up\com001}
  9. *                 --Comment Or Un-Comment Line Or Block With * In Col 1,
  10. *                   Blank Lines NOT Commented,
  11. *                   Pauses To Mark Block If Not Marked
  12. *                            (John Goodman And Tom Hogshead, Authors)
  13. * @(3)    {e:\up\com001}
  14. *                 --Comment Or Un-Comment Line Or Block With * In Col 1,
  15. *                   Blank Lines NOT Commented
  16. *                            (John Goodman And Tom Hogshead, Authors)
  17. * @(8)    {e:\up\com001}
  18. *                 --Comment Or Un-Comment Line Or Block With * In Col 1,
  19. *                   Blank Lines Are Commented,
  20. *                            (John Goodman And Tom Hogshead, Authors)
  21. * @(2)    {e:\up\com001}
  22. *                 --Comment Or Un-comment With "*»" In Col 1,
  23. *                   Blank Lines NOT Commented,
  24. *»                  (like this)
  25. * @(1)    {e:\up\com001}
  26. *                 --Add/Delete '*-- ' In Front Of Commenting Line,
  27. *--                 (like this)
  28. * @(4)    {e:\up\com001}
  29. *                 --Center Macro Comment * -- <Comment> --*
  30. * @(7)    {e:\up\com001}
  31. *                 --Remove Macro Comment * -- <Comment> --*
  32. * @(F1)   {e:\up\com001}
  33. *                 --Comment Non-macro Portion Of File
  34. * @(5)    {e:\up\com001}
  35. *                 --Un-comment Non-macro Portion Of File
  36. * @(F5)   {e:\up\com001}
  37. *                 --Original Commenting Macro     (John Goodman, Author)
  38. * ^(F5_)  {e:\up\com001}
  39. *                 --Original Un-commenting Macro  (John Goodman, Author)
  40. * #(F5__) {e:\up\com001}
  41. *                 --Revised Original Goodman Un-commenting,
  42. *                   Checks Before Un-commenting
  43. * @(F2)   {e:\up\com001}
  44. *                 --Comment Paragraph Or Block
  45. * #(F2__) {e:\up\com001}
  46. *                 --Builds A "Comment Box" For C Programmers,
  47. *                       (Tim Farley, Author)
  48. * @(F3)   {e:\up\com001}
  49. *                 --Comment Whole File
  50. * ^(F3_)  {e:\up\com001}
  51. *                 --Un-comment Whole File
  52. * #(F3__) {e:\up\com001}
  53. *                 --Center C Program Comment (Richard Blackburn, Author)
  54. *--
  55. * @(5)    {e:\up\com002}
  56. *                 --Make Macro Title Box
  57. * @(6)    {e:\up\com002}
  58. *                 --Copy Macro Title To Index
  59. * @(9)    {e:\up\com002}
  60. *                 --Remove Macro Title Box
  61. *--
  62. * #(F4__) {e:\up\com003}
  63. *       --Surround Column-Blocked Text With Box Of Desired Characters,
  64. *             (John Goodman, Author)
  65. *                                   ********
  66. *         (Box Drawn Around Outside *Border* Of Column Block, Juxtapose Text)
  67. *                                   ********
  68. * @(F4__) {e:\up\com003}
  69. *       --Erase Outside Border Of Column-Blocked Text And Collapse Text
  70. *         Surronding Block To Original Position Before Box Was Made,
  71. *             (John Goodman, Author)
  72. * @(F8)   {e:\up\com003}
  73. *       --Put Colon In Front Of "Rem" Lines For Faster Batch File Operation
  74. * ^(F7_)  {e:\up\com003}
  75. *       --Prepend Prompted Text To, Or Delete Prompted Text From,
  76. *         The Beginning Of The Current Or Blocked Line(s),
  77. *             (John Goodman, Author)
  78. * #(F7__) {e:\up\com003}
  79. *       --Prepend Prompted Text To, Or Delete Prompted Text From,
  80. *         The Beginning Of The Current Or Blocked Line(s),
  81. *         Initialize Find Prompt With Last Prompted Text
  82. *             (Tom Hogshead Modification Of ^F7)
  83. * @(F7)   {e:\up\com003}
  84. *       --Insert Text At Beginning Of All Blocked Lines,
  85. *             (John Goodman, Author)
  86. * @(8)    {e:\up\com003}
  87. *       --Insert Text at Beginning of Blocked Lines (or Current         |new
  88. *         Line If No Blocks Marked), John Goodman, Author
  89. *--
  90. * @(h)    Jump From Index Line To (Locate) Macro or Item In Document Below
  91. *
  92. *
  93. * (Index) - How to locate macro or item below from Index using @h
  94. * (Description)
  95. * (Startup)
  96. * (Macros)
  97. * (Other) Macros
  98. * (Version) history
  99. *
  100. *-- eoi
  101.  
  102. * (DESCRIPTION):  COMT16.QM contains macros to comment and un-comment
  103. * lines, blocks, paragraphs, macros, C programs, and dBase lines. Also
  104. * has macros to insert and delete text at beginning of lines or blocks,
  105. * macro to speed up batch file running, and macro to make and remove
  106. * boxes with any desired border surrounding text.
  107.  
  108. * (INDEX) USE: To locate a macro or item in this file, press @h, place
  109. * the cursor line on the desired item in the Index above, and press
  110. * <enter>. See BOOKxx.QM for more details.
  111.  
  112. * (STARTUP): To BEGIN, just type "START COMT" <Enter>. All pertinent
  113. * files will be loaded in the "Ring" for viewing, and COMT16.MAC is
  114. * read. Alternatively, type "START COMT 0" <Enter> and the disk copies
  115. * of all files in the "Ring" will be loaded ready for editing, saving
  116. * time.
  117.  
  118. * These macros require "QEdit and QMAC v2.1, February, 1990" or later.
  119. * For (other) macros, see ALLMACRO.INF.
  120.  
  121. * (MACROS)
  122. * ---------
  123. *  See subfiles 'com00x.qm' for macros.  Use @f in BOOKxx.QM to access
  124. *  macros.
  125.  
  126. * 
  127. * ----------------------------------------------------------------------
  128. * @(h)  Jump From Index Line To (Locate) Macro or Item In Document Below
  129. * ----------------------------------------------------------------------
  130.  
  131. *        Alt_h can be used to quickly jump from Index Line to the desired
  132. *        item or macro in the document below:
  133.  
  134. *        1. Press Alt and h at the same time. Line 1 is marked to
  135. *           highlight. Cursor down to desired line in Index.
  136.  
  137. *        2. Press Enter. The macro then locates and jumps to the item
  138. *           selected on the cursor line in the document below.
  139.  
  140. *   See BOOKxx.Qm and JMPPOSxx.QM in AMACxx.ZIP for more discussion about
  141. *   using bookmarks and positions markers ( ) to jump to positions in
  142. *   files.
  143.  
  144. @h macrobegin
  145.         unmarkblock                     * Unmark any marked blocks
  146.         defaultwordset                  * In case altwordset on
  147.         begfile                         * Go to file begin
  148.         markline markline               * And highlight line 1
  149.         pause                           * Pause for Index selection
  150.         wordright markword              * Mark first word on line
  151.         copy                            * Copy word to scrap
  152.         endpara                         * Go to end of Index
  153.         makectrofscreen                 * Cursor line center of window
  154.         find "(" paste ")"
  155.         return "I" return               * Find first marked word in doc
  156.         jfalse NOMARK:
  157.         begline                         * If mark found, go to begline
  158.         jump END:
  159.         NOMARK:
  160.         begfile                         * if no mark found, go to begfile
  161.     END:
  162. *
  163. * 33 bytes Wed  07-10-1991  10:11:24 (TH @1 in BOOKxx.QM)
  164.  
  165.  
  166. * (Version) History;
  167. *
  168. *   1.0 -   Initial
  169. *   1.1 -   Modified @5, @6 and @9 to handle multi-line titles.
  170. *       -   Added ^F7, #F4 and #F7
  171. *       -   Added @2 and @3
  172. *   1.2 -   Shortened #F4 from 92 to 67 bytes. Handles full documents OK.
  173. *       -   Modified @9 to remove macro title box if marked with JMPPOS.
  174. *   1.3 -   Shortened #f4 from 67 to 49 bytes. Added alternate version
  175. *           written by John Goodman.
  176. *   1.4 -   Added new #F4 written by John Goodman.
  177. *   1.4a-   Changed description of @2.
  178. *   1.5 -   Modified @8 description.
  179. *       -   Changed ^F6 key to #F5.
  180. *       -   Modified @5 to put position marker on top of box and pause to
  181. *           select title lines.
  182. *       -   Added @1 to Add/Delete '* -- ' In Front of Commenting Line, Like         <new
  183. *-- this.
  184. *       -   Added latest version of @h.
  185. *       -   Added [ ^cursordown ] to comment/uncoment without having to mark
  186. *           block before macro execuction.  Column/Char/Line blocks OK.
  187. *   1.5a-   Moved begline up in [ ^cursordown ] to keep cursor in col 1.
  188. *       -   Included in AMAC38.ZIP, July 21, 1991.
  189. *   1.6 -   Modified ^cursordown per John Goodman, shortened 3 bytes to
  190. *           71 bytes, July 24, 1991.
  191. *   1.6a-   Added subfiles com001/002/003, July 26, 1991.
  192. *       -   Added @8 to com003, July 28, 1991.
  193. *       -   Included in AMAC39A.ZIP.                                   7/29/91
  194. *   1.6b-   Changed ^f1 in com001.qm to @5.                            7/30/91
  195. *
  196.